Release 10.1A: OpenEdge Development:
ADM Reference

newQueryValidate

Inserts a new expression to the passed prepare string if the buffer reference, usually extracted from the expression, is valid. Returns ? if error (after an error message has been shown).

Location: query.p

Parameters:

INPUT pcQueryString AS CHARACTER

Complete query string to which the expression is going to be added.

INPUT pcExpression AS CHARACTER

The new expression to add to the query. The first field reference is used as buffer reference unless pcBuffer is defined.

INPUT pcBuffer AS CHARACTER

Optional buffer reference.

INPUT pcAndOr AS CHARACTER

Operator used to append if query string already has an expression. Default is "=".

Returns: CHARACTER

Notes:

The function avoids duplicate logic in add and setQueryWhere and acts as a wrapper for newWhereClause with some significant additions and differences:

The buffer reference is usually extracted from the new expression.
pcBuffer is optional and as a result is not the first parameter.
The buffer reference is validated and qualification does not need to match the original query.
Displays error message and returns "?" if the buffer is unknown or ambiguous.